package cn.lingyangwl.agile.msg.push.service;

import cn.lingyangwl.agile.msg.push.model.entity.Receiver;
import cn.lingyangwl.agile.msg.push.model.rqrs.receiver.*;
import cn.lingyangwl.agile.msg.push.model.rqrs.notice.SubscribeMsgNoticeResp;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;

/**
 * 消息接收者
 *
 * @author shenguangyang
 */
public interface ReceiverService extends IService<Receiver> {
    /**
     * 分页查询 消息接收者
     *
     * @return 返回分页数据
     */
    IPage<ReceiverResp> pageReceiver(ReceiverPageReq req);

    /**
     * 保存 消息接收者
     *
     * @param req 新增的记录
     * @return 是否保存成功
     */
    boolean saveReceiver(ReceiverSaveReq req);


    /**
     * 获取某个消息通知的订阅者(接收人)
     * @param noticeId 消息通知id
     * @return 接收人列表
     */
    List<ReceiverResp> listMsgSubscriber(Long noticeId);

    /**
     * 获取接收人订阅的任务
     */
    List<SubscribeMsgNoticeResp> listSubscribeMsg(SubscribeMsgListReq req);

    /**
     * 保存任务订阅者
     */
    void saveMsgSubscriber(MsgSubscriberChangeReq req);

    /**
     * 删除任务订阅者
     */
    void deleteMsgSubscriber(MsgSubscriberChangeReq req);

    /**
     * 更新 消息接收者
     *
     * @param req 修改的记录
     * @return 是否更新成功
     */
    boolean updateReceiver(ReceiverUpdateReq req);
    
    /**
     * 获取 消息接收者
     *
     * @param id 主键
     * @return 是否删除成功
     */
    ReceiverResp getReceiver(Long id);

    /**
     * 删除 消息接收者
     *
     * @param id 主键
     * @return 是否删除成功
     */
    boolean deleteReceiver(Long id);
    
    /**
     * 批量删除 消息接收者
     *
     * @param ids 主键集合
     * @return 是否删除成功
     */
    boolean batchDeleteReceiver(List<Long> ids);

    /**
     * 来自管理端的验证邮箱/手机号, 需要对方提供手机号或者邮箱验证码
     */
    void checkCaptchaFromAdmin(ReceiverVerifyReq req);

    /**
     *
     * @param req
     */
    void sendCaptcha(SendCaptchaToReceiverReq req);
}
